<?php

if (! defined('BASEPATH'))
    exit('No direct script access allowed');
/**
 * CodeIgniter
 *
 * An open source application development framework for PHP 5.1.6 or newer
 *
 * @package CodeIgniter
 * @author ExpressionEngine Dev Team
 * @copyright Copyright (c) 2008 - 2011, EllisLab, Inc.
 * @license http://codeigniter.com/user_guide/license.html
 * @link http://codeigniter.com
 * @since Version 1.0
 * @filesource
 *
 */
    
// ------------------------------------------------------------------------

/**
 * CodeIgniter Array Helpers
 *
 * @package CodeIgniter
 * @subpackage Helpers
 * @category Helpers
 * @author ExpressionEngine Dev Team
 * @link http://codeigniter.com/user_guide/helpers/array_helper.html
 */
    
// ------------------------------------------------------------------------

/**
 * Element
 *
 * Lets you determine whether an array index is set and whether it has a value.
 * If the element is empty it returns FALSE (or whatever you specify as the
 * default value.)
 *
 * @access public
 * @param
 *            string
 * @param
 *            array
 * @param
 *            mixed
 * @return mixed on what the array contains
 */
if (! function_exists('element')) {

    function element ($item, $array, $default = FALSE)
    {
        if (! isset($array[$item]) or $array[$item] == "") {
            return $default;
        }
        
        return $array[$item];
    }
}

// ------------------------------------------------------------------------

/**
 * Random Element - Takes an array as input and returns a random element
 *
 * @access public
 * @param
 *            array
 * @return mixed on what the array contains
 */
if (! function_exists('random_element')) {

    function random_element ($array)
    {
        if (! is_array($array)) {
            return $array;
        }
        
        return $array[array_rand($array)];
    }
}

// --------------------------------------------------------------------

/**
 * Elements
 *
 * Returns only the array items specified. Will return a default value if
 * it is not set.
 *
 * @access public
 * @param
 *            array
 * @param
 *            array
 * @param
 *            mixed
 * @return mixed on what the array contains
 */
if (! function_exists('elements')) {

    function elements ($items, $array, $default = FALSE)
    {
        $return = array();
        
        if (! is_array($items)) {
            $items = array(
                    $items
            );
        }
        
        foreach ($items as $item) {
            if (isset($array[$item])) {
                $return[$item] = $array[$item];
            } else {
                $return[$item] = $default;
            }
        }
        
        return $return;
    }
}

/* End of file array_helper.php */
/* Location: ./system/helpers/array_helper.php */